home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 430_01 / m68kdis / readme < prev    next >
Encoding:
Text File  |  1994-12-29  |  1.6 KB  |  36 lines
  1. m68kdis - disassemble Motorola 68000 family object code
  2.  
  3. m68kdis is a disassembler for the Motorola 68000 family of cpu chips
  4. (currently up to the 68030).  The disassembler attempts to discern
  5. between the instruction and data portions of an object code file.
  6.  
  7. Make sure you use an ANSI C compiler with full prototypes.  Then type
  8. ``make'' to build m68kdis.  If you want the Macintosh stuff, run make
  9. in the MAC directory also (you will need perl).
  10.  
  11. There are two methods provided for debugging.  The script ``wierd'' can
  12. be used; it seeks to point out LINK, UNLK, and RTS instructions that
  13. ended up being data.  If you think these were so interpreted
  14. incorrectly, you can use the -bad (which writes to standard error) or
  15. -all options to help figure this out.
  16.  
  17. MAC-SPECIFIC STUFF
  18. ------------------
  19. There's a file for A-line instructions for the Macintosh (MAC/mac.a).
  20. It undoubtedly is not complete and/or accurate for your code.  Often
  21. code that uses an A-line instruction not currently known will result in
  22. problems spotted by ``wierd''.  ``mac.0189'' is the file to add new
  23. instructions to (the lines must match /^a[0189]/).  ``mac.odd'' is for
  24. instructions that contradict mac.0189.  After editing, rerun make.
  25.  
  26. Four scripts, ``makes'', ``rftos.pl'', ``makeb.pl'', and ``maken.pl'',
  27. and the C program ``rf'' are provided to make it easier to format the
  28. output for a resource fork in a more Mac-friendly fashion.  A resource
  29. fork should be named <stem>.rf and ``makes'' should be called with the
  30. lone argument <stem>.
  31.  
  32. Suggestions and questions welcome.
  33.  
  34. Chris
  35. Christopher_Phillips@pe.utexas.edu
  36.